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The information on this sheet supersedes that on page X of the 
Toolbox manual under the heading "Loading Instructions." 

The disk you have received is a standard 40-track. double 

the"^^ Ki k K Ue f °r atted by LD0S - lt cont -- a" Tf 
the Toolbox utilities as described in the user's manual. 

You are urged to make at least two backups of the distribution 
disk for normal, day to day use. Do not use the distribution 
disk in your day to day operations. Keep it in a safe place as 
a hedge against that inevitable day when you find that all 
your working copies have been bombed. 

If your computer does not have double-density capability, send 
this disk back along with $5.00 to PowerSOFT, at the address 
found on page 5 of the manual and request that the programs be 
Placed on single-density diskettes. You will receive back two 
smgle-density diskettes containing all of the programs. 

The Toolbox utilities will work on LDOS versions 5.1.3 and 
iater.^he_..file__called ..PBOOTM/FIX is for MAX- 80 LDOS 514 
only. Do not attempt to use .these programs under any other 
^ q ng R Wtem including TRSDOS 6.x. If you are running 
1RSDOS 6.x exclusively, order the Toolbelt from PowerSOFT. 



PowerSOFT 's TOOLBOX FOR LDOS(tm) 



T'V. 



»1 V**-*- 



■f^iTh-r* 



T -T-*rv<=; 



Powerful Utilities for use with LDOS 5.1.x 
c 1982 by Breeze/QSD, Inc., Dallas TX 
This disk is a 40-track DDEN data disk 
Serial Number: 475012 



OVERVIEW 



The two disks you have received contain the utility programs 
which make up PowerSOFT's Toolbox for LDOS operating systems 
versions 5.1.3 and later. These are a powerful set of utilities 
which enable you to do a variety of tasks on disk files and 
memory, such as direct modification of disk sectors (PMOD) , 
checking and fixing directory errors (PCHECK and PFIX) , testing 
your disks for CRC and other formatting errors (PVU) , 
reformatting your LDOS disks without losing any data already 
there (PREFORM), searching for a particular string, byte or word 
value in a file or in an entire disk (PFIND) , and comparing two 
files or disks for differences (PCOMPARE) . 

In addition, PFILT/FLT is a general-purpose filter program 
which is user-definable, and which adapts itself for either input 
or output, depending on the device to which it is attached. The 
filter files may be created using the BUILD library command. Two 
example files, CODE/JCL and DECODE/JCL, are given to demonstrate 
how PFILT can be used. 

Have you ever wanted to use the DVORAK keyboard layout 
everyone is talking about? DVORAK/FLT will remap your keyboard 
into that layout. Alternatively, you may make use of PFILT/FLT to 
achieve the same results using the filter file DVORAK/JCL. 

Disk drive head movement may be tested and exercised with PEX, 
the all-purpose disk stepper exerciser. You may use this program 
in conjunction with a cleaning disk for more effective head 
cleaning (but use it sparingly!). 

Tired of using a bulk eraser you don't dare bring close to the 

computer? PERASE will do the job for you. It will absolutely 

remove all traces of data and formatting information from a 
diskette. 

If you just want to kill files from a diskette as fast as 
possible, the versatile PKILL utility will let you do so, in a 
variety of ways. You may specify files to be killed by class, 
category, or else provide a list. Much more versatile that the 
PURGE library command, and much faster. 

If you need to know where on a diskette a certain file 
resides, PMAP will tell you. Conversely, if you want to know what 
file a certain sector on the disk has been assigned to, if any, 
PSS, the Sector Status utility, will provide the information. 

PMOVE will allow you to move several files from one disk to 
another at the fastest possible speed. You may specify a list of 
files to move. This utility fills in the gap between a 
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Backup-by-class and a full Backup - that is, the case when you 

the^MlP fll ^, S WMCh d ° n,t haVG any common'characteristlcs^n 
their filenames that can be specified for a Backu P -by-class. 

mJr*rl Ve i U t l received a TRSDOS 1.3 disk that you want to 

CON vert over to LDOS, but you don't know exactly what's on it 

Why bother booting it up to do a DIR, when PDIRT will show vou 
the directory without having to leave LDOS at all? V 

d bv 'trsdos 3 Thi^ "^ \ si ngle-density LDOS disk can't be 
iallv L" C t n be an ann °y in 9 Problem sometimes, 
lally when you want to send a diskette to someone who 

oroblL LD ° S - , PUN ' thG UNREPAIR utility, will taK care of 
problem in a few seconds, it will write out the directory 
-I m J k ! l l!2 ! density Model I disk with the correct data 
-s marks that will make it readable by TRSDOS. Now you don't 
to bother installing patches in the operating system itself 
to reverse the action of the REPAIR utility. Just UNREPAIR 



User's Manual 



Mo 
read 
espec 
doesn 
that 
track 
add re 
have 
just 
the d 



on P f S ?V° rdS Car Y be re,noved from one or all files on a disk in 
one fell swoop by the PASSGO utility. Very handy for those cases 

each* ^?p d0 ! J ^ t0 keSP ty ^ ing U ^ e LD °S »aste y r password 

each file. And this one won't even ask you for a master password! 

ud w1^h C ^I ieS and unassi 9 ned actors on your disk can be cleaned 
up with the use of PCLEAR. This utility will zero out the 
unused directory slots and unused sectors if desired? ?f you want 

dLk or 5 "^ absolutel y no trace <>f a killed file remains on a 
disk for a hacker to find, use PCLEAR. 

PHELP provides you with on-line help for the LDOS librarv 

n^rby d at a a n il times^fV S ° X°° ^ haVe to kee P ^ "-n'-l 
will tell all. S3y LP ° IR " ° r " PHELP C0PY " and ifc 

For those of you who use an EPSON-MX-80 printer, you'll have 
noticed that trying to perform a screen dump of graphics can do 
very strange things to your printer. This is because the MX-So's 
graphics codes aren't the same ones used by the TRS-80? PMX/FL? 
wH III™ '^i, Pr °" em f ° r y0U ' A PP lied fc o the™ v e V 
tnem. ^ a graphlcs codes s ° that the MX-80 can understand 

Tired of looking at the big LDOS logo on bootup? Want to 
personalize your disks? Apply the PBOOT patch and giv your Sisks 
a new logo with your own 3-line personalized message! If we do 
say so ourselves, this logo looks a lot better. 9 

., The Allowing pages will g ive full detailed instructions on 
the use of each of these utilities and filters Please «S hh2 
instructions carefully before trying anything Mastic? ^ 



LOADING INSTRUCTIONS * 






The disks you have received do not have an operating system on 
JK;\lI 6y r 6 readable as ordinary LDOS da?a disks. However 
they also contain a special transfer system which wili move the 
files onto your own disks. THE MASTER DISKS CANNOT BE BACKED UPM 

Si^ttes^nfuJ^h ^ m ° Ve the filSS ° nt ° your own formatted 
diskettes and use those as your everyday working master. Put the 
original master disks away in a saf e y place place against that 
inevitable time when all your working disks are bombed out! 




».u y° u just prepared in any drive and tpl 1 

the program which drive it is on. it will transfer the fUes over 

out *L° ne \ RePSat the Pr ° CeSS With the second ™^r dis" ?hln 
put the masters away in a safe place. 



ingle 



densit E M ERI The deStlnatlon disks must be formatted in 

If you have only one drive, you may specify drive as the 
to^rdis^s! 5 " and ^ filS tranSfSr SySt6m -i" ti" you whin 

rnPV E ^° U ** ? 0T WlSh u° USe the tr ansfer system, merely use the 
dilL C °^ and to move the flles f^m the master onto^our own 
disks. Or you may use BACKUP with the (VIS) parameter Please 
don't specify (INV) or BACKUP will choke. Parameter. Please 
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USE WITH LDOS VERSIONS EARLIER THAN 5.1.3 
The TOOLBOX utilities are written for use with LDOS 



version 



5.1.3. Under no circumstances should they be used with the LTOS 
ar^nnT* PowerS0FT wi H not take responsibility for damage 
arising from using these programs under LDOS 5.0.x. 9 




PATCH 
PATCH 
PATCH 
PATCH 
PATCH 
PATCH 
PATCH 
PATCH 
PATCH 
PATCH 
PATCH 
PATCH 
PATCH 
PATCH 
PATCH 



PMOD/CMD (D00,6A=90) 
PCHECK/CMD (D01, 03=90) 
PFIX/CMD (D01, 69=90) 
PFIND/CMD (D07, 07=90) 
PCOMPARE/CMD (D02, 18=90) 
PREFORM/CMD (D00,C6=90) 
PVU/CMD (D00,CA=90) 
PERASE/CMD (D00, 99=90) 
PCLEAR/CMD (D01,CE=90) 
PSS/CMD (D01 f 2A=90) 
PMAP/CHD (D00,E7=90) 
PMOVE/CMD (D02,83=90:D02,A8=90) 
PASSGO/CMD (D01, 45=90) 
PEX/CMD (D00, 61=90) 
PKILL/CMD (D01,C3=90) 



m 



Any file which does not appear on this list does not 
patching. Remember, these patches are for MODEL III only? 



PMOD 



The PMOD Utility is a 
Modification Utility. it alio 
memory and disk storage systems, 
may be operated on, incl 
Single/Double Sided, 5" and 8" f 
disk systems. It has a full sere 
with both HEX and ASCII formats 
for easy modification. The user 
modify in HEX, ASCII, DECIMAL, B 
of the PMOD command is: 



comprehensive Disk/File/Memory 
ws easy user interaction between 
All LDOS supported disk devices 
uding Single/Double Density, 
loppies and fixed/removable ri<jid 
en display of 256 bytes at a time 
, and makes use of dual cursors 
can go to the heart of a disk and 
INARY, or OCTAL input. The syntax 



need 



PMOD,aaa 

PMOD,f ilespec,bbbb 

PMOD,:c,d,e 

aaaa = memory address to modify 

filespec = any valid LDOS filespec 

bbbb = relative file sector (optional) 

:c = drive to modify (0-7, colon mandatory) 

a = cylinder number (defaults 0) 

e - sector number (defaults 0) 

abbr: NONE 



NOTE: It is recommended that you SET *KI KI/dvr Midi h f nPO 
using^ntering PMOD so the controAeys Ind'scJJiSpJlJ&^f J°£ 



T co e mmand re iin:? deS ° f ^^^ of the P">9™«" as indicated by 



the 



Memory Modify 




the 
spec 



contents J ? '"l" and » ressl ^ <ENTER>, you will view 
nf f "f"' 5 of 1 P?3 e ° f memory (256 bytes) starting at the 
cified address. Please refer to the following screen dump: 
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3000 


.C35E 


32C3 


9B32 


C374 


32C3 


DA32 


C3C0 


HEX 3010 


.D131 


C3AB 


34C3 


5534 


C3C2 


35C3 


FB35 


MEM 3020 


.36C3 


8036 


C38E 


33C3 


3937 


C3F7 


31C3 


3030 


.C399 


37C3 


BB35 


C3A0 


35DB 


E4CB 


6FC3 


3040 


.18D3 


C3B5 


3740 


6162 


6364 


6566 


6768 


3050 


6B6C 


6D6E 


6F70 


7172 


7374 


7576 


7778 


3060 


3AEA 


37B7 


C930 


3132 


3334 


3536 


3738 


3070 


3B2C 


2D2E 


2F0D 


1F01 


5B0A 


0809 


2021 


3080 


22FF 


41AF 


C960 


4142 


4344 


4546 


4748 


3090 


4B4C 


4D4E 


4F50 


5152 


5354 


5556 


5758 


30A0 


77AF 


C9AA 


AA00 


2122 


2324 


2526 


2728 


30B0. 


2B3C 


3D3E 


3F0D 


1F01 


1B1A 


1819 


203E 


30C0. 


1940 


AE18 


DB40 


4142 


4344 


4546 


4748 


30D0. 


4B4C 


4D4E 


4F50 


5152 


5354 


5556 


5758 


30E0. 


CDD9 


01AF 


C930 


3132 


3334 


3536 


3738 


30F0. 


3B2C 


2D2E 


2F0D 


1F01 


5B0A 


0809 


2028 



31C3..*2..2.t2..2..1. 
C35A..1..4.U4..5..5.Z 
7B37.6..6..3.97..1.{7 
1C35...7..5..5...0..5 

696A 7@abcdefghij 

797A.klmnopqrstuvwxyz 
393A.:. 7. .0123456789: 
DC05.J ;,-./. ..[... I.. 
4 94A.".A..@ABCDEFGHIJ 
595A.KLMNOPQRSTUVWXYZ 

292A.W l"f$%S,» ()* 

0121.+< = >? >.] 

494A..@...@ABCDEFGHIJ 
59 5A.KLMNOPQRSTUVWXYZ 

393A 0123456789: 

E1A6. ;,-./. ..[... (.. 



The far left column of the screen indicates the current 
modification BASE (HEX, DECimal, ASCii, OCTal, BINary), and the 
MEM indicates that you are in the memory modify mode. The next 
column is the 4 character HEX address where the data is that you 
are viewing. The center columns of the display is the HEX 
representation of the 16 bytes starting at the address indicated 
at the row beginning. There is a space between each quad (2 
bytes, 4 HEX ASCII characters) for easier viewing. On the far 
right is the representative ASCII character of the 16 bytes on 
that row. All bytes less than 20H (32 decimal) are displayed as a 
period (.) to indicate a non-printing character. Graphics 
characters are also printed as periods in this illustration, 
however they will show up as graphics on your screen. You are now 
in the memory paging mode . Several keys are active at this point: 

BREAK - terminate the program 

SHIFT CLEAR - prompt for a new address 

M - enter MODIFY mode 

A - set ASCII modify 

B - set BINARY modify 

D - set DECIMAL modify 

H - set HEXIDECIMAL modify 

- set OCTAL modify 

X - prompt for new source data 

RIGHT ARROW - increment displayed address by 1 byte 

LEFT ARROW - decrement displayed address by 1 byte 

UP ARROW - increment displayed address by 1 page (256 

bytes) 
DOWN ARROW - decrement displayed address by 1 page 
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Disk Modify 

Enter a Drive, Cylinder, and Sector where modification is to 
begin. You must precede the drive number with a colon (:) to 
distinguish it from a memory address. The cylinder and sector 
numbers default to if not issued. The cylinder may be answered 
with the at symbol (@) to page directly to the directory track. 

After answering the prompt and pressing <ENTER> the specified 
sector will be read from disk and displayed on the video. Please 
refer to the following screen dump: 





00 


.0300 


FDCB 


035E 


2803 


210C 


62ED 


B0FD 


HEX 


10 


.5E20 


353E 


53FD 


CB03 


7628 


023E 


0102 


DRV 


20 


.4432 


413F 


3E44 


3242 


3F3E 


53FD 


CB04 





30 


.023E 


4432 


813F 


3E53 


3282 


3FFD 


CB03 


CYL 


40 


.210F 


6211 


C03F 


0103 


00ED 


B0C9 


1140 


11 


50 


.0300 


FDCB 


0356 


2192 


6020 


0321 


9560 


SID 


60 


18D9 


2104 


3C11 


4164 


0140 


003E 


10F5 





70 


FE3A 


2816 


FE03 


2812 


FE0D 


280E 


FE2E 


SEC 


80 


B728 


0777 


09F1 


3D20 


E4F5 


F121 


F461 


05 


90 


3C01 


0300 


EDB0 


DD21 


5F64 


DD7E 


06C6 


STD 


A0. 


C13C 


21BA 


6111 


003F 


0104 


00ED 


B0DD 


b" 


B0. 


3FDD 


7E00 


F52A 


C55E 


CDC9 


54F1 


323F 


H1G 


C0. 


BE61 


1180 


3F01 


0400 


EDB0 


DD21 


BF3F 


FIX 


D0. 


00F5 


2A65 


5FCD 


C954 


F132 


BF3F 


C921 




E0. 


1180 


3C01 


0300 


EDB0 


2AC0 


5511 


4000 




F0. 


033C 


3E10 


F57C 


CDB0 


54FD 


7100 


FD70 



CB03 ~(.!.b 

0057." 5>S...v(.>...W 
6E28.D2A?>D2B?>S...n( 
7EC8..>D2.?>S2. ?...-. 

3F01.1.b..? §?. 

EDB0 vj .§ .!.§.. 

1A13. .. 1. <. Ad. §.>.... 
280A. .:(... (...(...(. 
1180.. (.w..= ...J.a.. 

3032. < !_d.~..02 

213F..<l.a..? I? 

3F21. ?.-..*.".. T.2??I 

DD7E..a..? ! .?." 

F857...*e_..T.2.?. ! .W 

FD21...< *.U.@.. ! 

017D..O.. | ..T.q..p. } 



The screen format is similar to Memory Modify except for the 
tar left column of data, which indicates the source of the 




or double). If a Rigid drive, you are told i£ it is Fixed or 
Removable. You are now in the sector pagin g mode. The followinq 
keys are active: ^ 

BREAK - terminate program 

SHIFT CLEAR - prompt for new drive, cylinder, and 

Sector 
M - enter MODIFY mode 
A - set ASCII modify 
B - set BINARY modify 
D - set DECIMAL modify 
H - set HEX modify 
- set OCTAL modify 
X - prompt for new source data 
0-9 - page to corresponding sector 
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§ - page to current sector on directory track 

R - restore drive to cylinder 0, sector 

RIGHT ARROW - increment sector 

LEFT ARROW - decrement sector 

UP ARROW - increment track 

DOWN ARROW - decrement track 

SHIFT RIGHT ARR ™ a ~ P*9e to highest sector on current 

SHIFT DOWN ARROW^page to lowest sector on current 

t rack 
SHIFT UP ARROW - page to highest cylinder on disk, 
current sector 



File Modify 

Enter a filespec that you wish to view, 
follow the filename with the relative sec 

riBdbe rerer to the following screen dump: 



You may optionally 
sector that you wish to 





D00 


.0506 


4445 


4C20 


2020 


1F18 


5665 


7273 


HEX 


Ely 


• 6E20 


3228 


3130 


2920 


2D20 


3039 


2F32 


DRV 


L20 


.3832 


0102 


0052 


7EFE 


0DCA 


B252 


FE2F 





/J0 


.114E 


5323 


CD1C 


44DD 


214D 


533A 


4038 




C40 


.CADD 


5211 


5153 


CD1C 


4428 


0AFE 


0D20 




Mb0 


.E952 


C32D 


40CD 


4252 


CD24 


44C2 


BB52 




Db0 


4420 


7EDD 


3400 


18D3 


3A4E 


53B7 


C8E5 




70 


5221 


4E53 


3A54 


003D 


2010 


CD73 


443A 




80 


B7C4 


9052 


E1AF 


324C 


53C9 


CD4B 


443A 




90. 


B7C4 


9052 


18EE 


2151 


537E 


FE3A 


2806 




A0 


C823 


18F5 


3E01 


324C 


53D5 


C511 


4953 




B0. 


00ED 


B0C1 


D1C9 


D511 


5153 


1AFE 


0328 


RSEC 


C0. 


3A28 


0313 


18F4 


E5C5 


2149 


5301 


0300 


0000 


m. 


AF32 


4C53 


C1E1 


D1C9 


2110 


53CD 


6744 


EOFS 


E0. 


40E5 


F53A 


5153 


CB7F 


2803 


CD28 


4421 


0002 


F0. 


CD67 


4421 


2F53 


CD67 


44F1 


F6C0 


CD09 



696F...DEL ..Versio 
382F.n 2(10) - 09/28/ 

2007. 82. ..R- R./ . 

FE04..NS#..D.!MS:?8.. 

ECCD R.QS..D( 

CD2C..R.-g.BR.$D..R., 

CD70.D ~.4...:NS p 

4C53.R!NS:T.= ,.sD:LS 
4C53....R..2LS..KD:LS 
FE03....R..IQS-.: (. 
0102..|..>.2LS...IS 

07FE QS... ( 

EDB0.: ( IIS... 

C330..2LS.... J.s.gD 
5153.e..:QS{.. (DJQS 
44El..gD!/S.gD D. 



f«r m S " eei ? c la V°"t is similar to that of Memory Modify, except 
for the far left column. You are given the drive number that vou 
are working on. The filename that you are viewi d a I 
vertically starting just to the right of the curso ? Ill] lit 
bottom you are given the relative sector you are viewing and the 

rreif^^ be abrrto^ierup' e 

Several keys are acUve: ^ ^ ^ ln the tile paqi ™ *° de - 

BREAK - terminate program 

SHIFT CLEAR - prompt for a new relative sector 

M - enter Modify mode 
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A - set ASCII modify 

B - set BINARY modify 

D - set DECIMAL modify 

H - set HEX modify 

- set OCTAL modify 

X - prompt for new source data 

nJ G ALnw R ° W " lncren,en t to the next relative sector 
UP ARROW - same as right arrow 

LEFT ARROW - decrement to next relative sector 
DOWN ARROW - same as left arrow sector 



NOTE; 



will NnT Wh h2 US -?2 the FILE M0DIFY option on DIR/SYS, the sectors 
LDOS nSr air'intentf Re * d - protec ted , making it unreadable to 
r*i?«.ni« et intents and purposes and requiring a "Repair 

(alien)" after updating back to the disk. Use the DISK MODIFY 
(option to correctly handle the directory track. * * 

Modify Mode 

oper^tion DI aL T^* J S ^7°" t0 3l1 ° £ the above 3 modes of 
operation, and is entered by pressing M when the desired dat-;, i 
being viewed in one of the above paging mo2es The curso? win 
-ove into the HEX and ASCII portions of he i fdua 

cre S :n S dumpr d ^ "^ ^ rapid1 *' Refer to thTf^lo^ng 



sc 



00] D00 

HEX E10 

DRV L20 

/30 

C40. 

M50. 

D60. 

70. 

80. 

90. 

A0. 

B0. 

RSEC C0. 

0000 D0. 

EOFS E0. 

0002 F0. 



0506 

• 6E20 
.3832 

• 114E 
.CADD 

• E952 
.4420 
.5221 
.B7C4 
.B7C4 
.C823 
.00ED 

3A28 
AF32 
40E5 
CD67 



4445 

3228 

0102 

5323 

5211 

C32D 

7EDD 

4E53 

9052 

9052 

18F5 

B0C1 

0313 

4C53 

F53A 

4421 



4C20 

3130 

0052 

CD1C 

5153 

40CD 

3400 

3A54 

E1AF 

18EE 

3E01 

D1C9 

18F4 

C1E1 

5153 

2F53 



2020 

2920 

7EFE 

44DD 

CD1C 

4252 

18D3 

003D 

324C 

2151 

324C 

D511 

E5C5 

D1C9 

CB7F 

CD67 



1F18 5665 7273 696F...DEL ..Versio 
2D20 3039 2F32 382F.n 2(]0) - 09/28/ 

0DCA B252 FE2F 2007.82. ..R~ R./ 

214D 533A 4038 FE04 . . NS# . .D. ! MS • @8 
4428 0AFE 0D20 ECCD. . .R.QS. . D ( 
CD24 44C2 BB52 CD2C. . R.-§. BR. $d! !r" 
3A4E 53B7 C8E5 CD70.D ".4...:NS. p 
2010 CD73 443A 4C53 .RJ NS :T. = ..sD*LS 

53C9 CD4B 443A 4C53 R..2LS. 

537E FE3A 2806 FE03 R..!QS~ 

53D5 C511 4953 0102. . | . . >. 2LS. . , 

5153 1AFE 0328 07FE QS. 

2149 5301 0300 EDB0.:( US.... 

2110 53CD 6744 C330..2LS I.S.gD^ 

2803 CD28 4421 5153. 0. . : QS< . . (Dl OS * 
44F1 F6C0 CD09 44E1 . .gD!/S. gD D 



,KD:LS 

,: (... 

.IS. . 

(.. 



hv,^ th f^°P ^ ft ° f the display, you are given the relative 
byte within the displayed data where the cursor liftoff 
following keys are active at this poTnt": E ^^ 

BREAK - abort the modify mode, re-read the source data as it 
was before any changes were made, and return back to pi 
mode you came from. NOTE: In the MEMORY node, the chan e 

mmediate, and cannot be re-read. In this case the BREAK key is 
identical to pressing the ENTER key. Y 
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22 XOG. 

HEX DID, 

DRV 120 

R30 

MO 

C50 

M60 

D7D 

80 

% 



RSEC CO 

0000 DO 

0001 E0 
F0 



< 



01FE FC52 
363F 233^ 
6AD3 ..02 
DOED B011 
2336 0021 
.2356 216A 
,AF53 2172 
.4E77 0600 
.F579 B728 
.0003 1168 
.7C12 1B7D 
.ED52 CB7C 
.23E5 D121 
.DCDfc 2168 
.4F7E 7138 
.131A EDB1 



D321 7403 
0023 3ED2 
0B22 7603 
82D3 1A6F 
6AD3 3600 
D34E 2346 
D37E 2168 
0311 D8D6 
0406 OOED 
A7ED BOH 
12E5 1176 
CA2B 53C3 
B253 QE01 
B77E FEOO 
4E4E 22D8 
3E00 2031 



0102 OOED B021 
32AF 402A 8AD3 
1182 D321 8AD3 
131A 677E 2172 
2336 0023 2172 
D5E1 B7ED 427C 
A536 0123 7721 
EDBO 2168 A54E 
BQ21 D8D6 F177 
B2D3 1A6F 131A 
D31A 6F13 1A67' 
B353 2021 6BB7 
0600 EDBO 2100 
284D 22DA D621 
0606 0023 ED5B 
2BC5 E5ED 5BD8 



6A03.A..R.!t.AB3..!j 

ED5B.6?8638>B2.3#...L 

Q102J...KVQ..L.AI 

D377.a..Q..ZoSZg~!r.i= : 

D35E.»63!j.6MB63lt!r.' 

B5CA.*V!j.N»F — B!.. 

68A7..S!r.~!h.6ARu!h. 

8123.NyF3CQ....!h.N. 

4F06..y.(DF3..!...uOi 

6723.3CQh...Q..ZoSZg 

DlAF.!R[]R.Qv.ZoSZg. ; . 

3601..R.I.+S..S !h.6; 

Q022.8..!.SNAF3..!33. 

6BA7...!h.~.a(M"..!h: 

DAD6.0~.8NN"..F3».[. ; ' 

D61A.5Z..>3 !+...[..' 



At the top left of the display, you are given 
the relative byte within the displayed data where 
th e cursor lies . The following keys are active at 
this point: 

BREAK - abort the modify mode, re-read the 
source data as it was before any changes were 
made, and return back to the paging mode you 
came from. NOTE: In the MEMORY mode, the 
changes are immediate, and cannot be re-read. In 
this case, the BREAK key is identical to pressing 
the ENTER key. 

ENTER - terminate the modify mode, and write 
the modified data back to the source with all 
changes, and return to the paging mode you came 
from. NOTE: Changes are immediate in the 
MEMORY mode, and control is merely passed back 
to the paging mode. 



SHIFT CLEAR - allows you to change the 
modification mode BASE without leaving modify 
mode. You will have a new flashing prompt in the 
left column of the display. Enter A, B, D, H, or O 
(or Q) to set ASCII, BINARY, DECIMAL, HEX, or 
OCTAL bases respectively. Any other keys will be 
ignored. You will then return back to the modify 
mode at the same location you came from. 

ARROW KEYS - move the cursor 1 byte in the 
corresponding direction without affecting any of 
the bytes. 

SHIFT ARROW KEYS - move the cursor to 
extreme row or column ends in the associated 
direction without affecting any of the bytes. 

NOTE: In the DISK MODIFY and FILE MODIFY 
modes you will not be able to move the cursor 
beyond the edges of the displayed data. In 
MEMORY modify, if you attempt to move the 
cursor beyond the edges, additional data is brought 
to the screen to supply the desired information. 

If you are in the ASCII MODIFY mode , and the 
key you enter does not apply to any of the above 
conditions, then that character is entered at the 
current cursor location, and the cursor is advanced 
by one byte. 

If you are NOT in ASCII modify, several 
additional features are available: 

Q - position the cursor to the last byte of the 
currently displayed page. 

S - position the cursor to the first byte of the 
currently displayed page. 

G - followed by a number moves the cursor 
immediately to the relative byte in the page that 
you are viewing. 
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L - followed by a number moves the cursor to 
the next occurrence of the specified byte. The 
cursor will move to the last byte on the screen if 
the requested byte is not located. 

+ - followed by a number positions the cursor 
that many bytes FORWARD from its current 
position. 

- - followed by a number positions the cursor 
that many bytes BACK from its current position. 

P - followed by a number duplicates (propagates) 
the current byte located under the cursor to the 
following indicated number of bytes. 

< - will shift all bytes from the cursor to the 
page end by one byte, and place a zero at the last 
location on the screen. This allows you to delete 
text at the cursor. 

> - will shift all bytes from the cursor to the 
page end by one byte, and place a zero at the 
current cursor location. This allows you to insert 
text at the cursor. 

Z - fills the data buffer with ZEROES starting 
at the current cursor position. 

The above commands are disabled in the ASCII 
MODIFY mode, and will merely insert the character 
into the text. 

If you are not in ASCII modify, and none of 
the above conditions are met, then the input is 
interpreted as numeric input. If you are in HEX 
mode, for example, you must enter two HEX digits 
(0-9, A-F) to change a single byte. Decimal mode 
expects 3 digits (0-9), Octal mode expects 3 digits 
(0-7), and Binary mode expects 8 digits (0-1). You 
may pre-terminate the numerical input by pressing 
ENTER. Thus, in HEX mode, 3 <ENTER> is the 
same as entering 3, in Binary mode, 111 
<ENTER> is the same as entering 00000111. 
When you are in the middle of entering a number, 
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the cursor will change to indicate that more input 
is required to complete the current operation. If 
you enter incorrect digits before completing the 
number, entering an invalid character will terminate 
the entry. Thus, in HEX modify, you type a 3, but 
meant to enter a 4, just hit an invalid key (X for 
example) to terminate the operation and leave the 
byte unchanged. In the above special commands, G, 
L, P, + and -, the numeric input following the 
command must be in the current base. If you are 
in HEX modify, then G10 is a valid command to 
move the cursor to relative byte 10H, but in 
DECIMAL modify, you must enter G016 to achieve 
the same results. 

Any key that does not meet any of the above 
conditions will be ignored. 

When first entering this program, the data 
source information may be entered directly from 
the LDOS™ READY command line, or will be 
prompted for if not supplied with the command. If 
you wish to examine a file that could be 
interpreted as an address (for example, AFCH/CMD 
or D0123/TXT), you may precede the filename with 
an exclamation point (!) to force PMOD to 
interpret it as a filespec. For example, 
PMOD.FOOOH will display memory address F000H, 
but PMOD.IF000H will display the file F000H. 
Alternatively, you may attach a drive specification 
to the file name to force it to be treated as such, 
for example, F000H:0 will be seen as the file 
F000H on drive zero rather than the address 
F000H. 
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The PCHECK Utility is a comprehensive 
directory check utility. It allows the user to 
completely check the integrity of disk storage 
systems. All LDOS™ supported disk devices may be 
operated on, including Single/Double Densi y, 
Single/Double Sided, 5" and 8" floppies rnd 
fixed/removable rigid disk systems. This program 
will locate and report any inconsistencies in i he 
directory information of a disk. In conjunction wth 
PFIX, most directory problems can be easily 
corrected without extensive knowledge of how 
directories are formatted. The syntax of (he 
PCHECK command is: 



PCHECK, *,:a ! 

PCHECK,*,filespec 1 

I 
:a "• drive number to check (colon optional) I 
filespec - any valid LDOS™ filespec I 

1 
an asterisk (*) preceding the parameters will ! 
send the output to the video and printer ! 

! 
abbr: NONE ! 



After selecting the mode of operation (full dr.sk 
or file), the entire directory of the indicated d sk 
is read into memory. If not enough memory is 
available, it will be reported, and the program v ill 
abort. If any errors occurring during the directcry 
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read, they will be reported, and the program will 
pause and allow you to select a R>etry, S>kip, or 
A>bort. Although it is possible to check even an 
unreadable directory, unpredictable errors may be 
reported. For the normal operation of this program, 
it is assumed that all sectors of the directory are 
readable , even though the data contained therein 
may be incorrect. 

Each file specified is passed through a three 
stage check. This will either be the single file 
specified, or all files if an entire disk is specified. 
In the first stage, the integrity of the files' 
directory entry is checked. In the second stage, 
the associated HIT table bytes are checked. In the 
third stage, the associated GAT table bytes are 
checked. When all specified files have been 
checked, and all errors have been reported, a total 
error count will be issued and the program will 
exit back to LDOS™. 

The utility PFIX/CMD is capable of fixing most 
errors that may be reported by PCHECK. 

The following is a list of the possible error 
messages that PCHECK may report. A technical 
section will follow that will describe the logic used 
by PCHECK, and probable causes for the error 
conditions. 



ERROR MESSAGES 

1. Cylinder xxx has an invalid GAT table byte 

2. HIT byte at xxH invalid or extraneous 

3. Filename contains non-ASCII characters 

4. End of File Sector beyond allocated sectors 

5. No terminator for extent field 



Copyright °1982 by Breeze/QSD, Inc. 



22 



The TOOLBOX for LDOS 



User's Manual 



-23" 



6. Directory links to record not linking back 
to it 

7. Track assigned that is beyond diskette 
boundary 

8. Extension assigned before end of extents 

9. Forward 4ink to inactive entry 

10. Forward link to non-extension entry 

11. Extension record not assigned to any files 

12. Multiple files assigned to single granule 

13. Directory record has invalid HIT byte 

14. Directory record has a zero HIT byte 

15. Extended directory record has invalid HIT 
byte 

16. Extended directory record has a zero HIT 
byte 



Directory Check Logic 

This section contains the logic that PCHECK 
uses to determine the correctness of the directory. 
The novice user need not be concerned with this 
information as it is offered only as technical 
reference for the advanced user. 

During passes 1-3, if an error is found, it is 
reported in the following format: 

filename/ext @ Directory Sector xx, Relative 
Byte xxH. 

"error message string" 

If a non-ASCII character is found in the 
filename, its position will be highlighted with a 
graphic block. In all errors reported in the above 
format, the directory location will refer to the 
primary directory record, regardless of where the 
error occurred along the file. 



Pass 81 

Check to be sure that all 11 bytes of the 
filename contain characters within the range of 
20H to BFH (printable ASCII characters). If any 
are found to be outside this range, report error 3. 
The offending characters are displayed as a 
graphic block to aid in identifying their positions. 

The 5 extents of the associated record are 

each checked on a sector by sector basis. If any 

extent points to a track that is beyond the 
diskette boundary, an error is reported. 

If all 5 extents have been parsed, and no 
terminator is found (FEH or FFH) then error 5 is 
reported and the program terminates. 

If an extended record is found, and it is not at 
the 5th position in the extent field, error 8 is 
reported and the error scan continues. 

If the extended record is found, locate its 
position in the directory. If bit 4 of the first byte 
in the record is not set (inactive file), error 9 is 
reported and the program terminates. If bit 7 is 
not set (not an extension), error 10 is returned and 
the program terminates. The second byte in the 
extended record is a link back to the previous 
record. If this byte is incorrect, error 6 is 
reported and the program terminates. 

This process continues until an FFH terminator 
is reached, or a terminal error is found. 

When processing is completed, the number of 
sectors assigned to the file is calculated and 
compared to the end of file sector in the directory 
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record. If the end of file is larger than the 
allocated records, error 4 is reported. 



Pass 82 

This pass checks the integrity of the associated 
HIT byte for the current file. Each file is tracec 
from its primary directory entry through all extent? 
until an FFH terminator or a terminal error is 
reached. 

If the primary directory entry contains ar 
invalid HIT byte, PCHECK returns error 13 anc 
continues. If the primary directory entry contains e 
zero HIT byte, error 14 is returned. 

If an extended directory record contains ar 
invalid HIT byte, error 15 is returned. If ar 
extended record contains a zero HIT byte, ther 
error 16 is reported. 



Pass 83 

This pass checks the integrity of the associatec 
GAT bytes for the current file. As with pass 2 
each file is traced through all of its extents. 

If the current granule has already beer 
allocated (either by itself or another file), ther 
error 12 is displayed. NOTE: Only a single error 1J 
will be reported for a single file even though there 
may be several occurrences of it. 

When these steps have all been completed, am 
a single file has been specified, the number oi 
errors will be reported and an exit will be madr 
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back to LDOS™. If an entire disk is specified, 
three additional checks are made on the directory. 

Check 81 

When Pass ttl is made in the above process, it 
checks every directory record that has bit 4 set 
and bit 7 NOT set (active primary directory 
record). As the current file is being checked, bit 5 
of all the associated directory primary and 
extended records is set to indicate a completed 
file. During the Check ttl phase, the entire 
directory is re-scanned. If any files have bit 4 set, 
and not bit 5, then bit 7 MUST be set or error 11 
is reported. This condition indicates an extended 
directory record that has not be linked to any 
primary record (an extraneous directory record). 
This condition could result if one of the above 
passes terminates on a fatal error and an extension 
is not checked. If no terminal type errors are 
reported, but error 11 was issued, then there is an 
extra record in the directory that is not associated 
with any files. 

Check tt2 

As the program processes pass tt2, it completely 
builds a second HIT table in another buffer. During 
the check tt2 phase, the computed table is 
compared byte for byte with the HIT table as read 
from the diskette. If any of the bytes do not 
match, then error 2 along with the relative byte of 
the mismatch is displayed. If none of the pass tt2 
errors are reported, but error 2 is issued, then 
there is an extra byte in the HIT table at the 
corresponding location. 



Copyright °1982 by Breeze/QSD, Inc. 



Copyright °1982 by Breeze/QSD, Inc. 



•4 f 



26 



The TOOLBOX for LDO S 



Check 83 

As the program processes pass #3, it completely 
builds a second GAT table in another buffi r. 
Before check 3 is made, the disk lockout table is 
overlaid onto the built GAT table so that lock >d 
out tracks will not be counted. During the che ;k 
tt3 phase, the computed table is compared byte f )r 
byte with the GAT table as read from the disket :e 
for as many tracks as there are on the disk, [f 
any of the bytes do not match, error 1 and t ie 
relative cylinder of the mismatch is returned, [f 
none of the pass 83 errors are reported, but err >r 
1 is issued, then there are extra grans allocat sd 
on the disk that are not assigned to any files. 

Sometimes, one type of an error will inherent ly 
cause another type of error. In these cases, fixi g 
even one error may correct several others. As n 
example, if there is no terminator for a record, 
chances are that error 12 will be reported also, [f 
a terminal error is found in a directory link to n 
extension, error 2 may also be reported. 

When using this utility on Rigid drives, there is 
one error that may be reported that should >e 
considered normal. LDOS™ sets aside an ext a 
track right next to the directory, and shows tl is 
track as allocated in the GAT table. This track is 
used by the Laredo and Radio Shack hard dri e 
systems as overhead, and should not be use 1. 
PCHECK may report an invalid GAT Table Byte it 
this track location, and it should be consider d 
normal. The Laredo or Radio Shack rigid drive us ;r 
should be aware of this problem, especially as it 
relates to the PFIX utility, which may de-alloca e 
this track, or allocate it to an unassigned file. 
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Similarly, using PCHECK on a Model I double 
density system disk with a SOLE track will result 
in an "Invalid GAT byte" error. This is because the 
SOLE modification system allocates track to 
prevent the system from attempting to use 
non-existent sectors on it. This error should be 
considered normal and should not be fixed. 
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PFIX 



! ! 

! At least ONE parameter MUST be specified. 1 

! • ■ I 

! abbr: NONE I 



The PFIX program is a comprehensive director' 
repair utility. It allows the user to complete! 
repair most directory problems, and also has th j 
ability to transfer a faulty boot sector from i 
good disk. All LDOS™ supported disk devices may 
be operated on, including Single/Double Density 
Single/Double Sided, 5" and 8" floppies and fixe 
or removable rigid disk systems. This program wil 
locate and repair most inconsistencies in th 
directory information of a disk. In conjunction wit 
PCHECK, most directory problems can be easil; 
located and corrected without extensive knowledg 
of how directories are formatted. The syntax o 
the PFIX command is: 



PFIX:a,G,H,F,B-:d,L,R,P 

:a - drive number to fix (colon optional) 
G - repair GAT table 
H - repair HIT table 
F - repair missing/invalid File data 
B - repair BOOT sector 
:d - take boot sector from this drive 
(mandatory if B is specified) 
L - indicates a LAREDO rigid disk 

system 
R - indicates a RADIO SHACK 

rigid disk 
P - prompt for cyls, density, sides 
(should be last parameter 
specified) 



After selecting the desired parameters, the 
entire directory of the indicated disk is read into 
memory. If the P option is not specified, the 
program will use the information supplied by 
LDOS™ defining the diskette cylinder count, number 
of sides, and density. This information is located in 
the GAT sector of the diskette at format time. If 
it is possible that this particular information is 
invalid, use the P option, and you will be prompted 
to enter these parameters. If, for example, the 
entire GAT sector is zeroed out, LDOS™ will report 
this to be a "xxxxxx density, single sided, 35 
track" disk. If the GAT is fixed using these 
parameters, and the disk is REALLY a 40 track 
disk, the corrections will be inaccurate. 

If not enough memory is available, it will be 
reported, and the program will abort. If any errors 
occurring during the directory read, they will be 
reported, and the program will pause and allow you 
to select a R>etry, S>kip, or A>bort. Although it is 
possible to repair even an unreadable directory, 
unpredictable errors may be generated. For the 
normal operation of this program, it is assumed 
that all sectors of the directory are readable , even 
though the data in them may be incorrect. 

Each file of the directory is passed through a 
three stage process. In the first stage, the 
integrity of the files directory entry is fixed. In 
the second stage, the associated HIT table bytes 
are fixed. In the third stage, the associated GAT 
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table bytes are fixed. When all specified files have 
been checked, and all errors have been corrected, 
the corrected data will be written back to disk per 
the command parameters. Either the GAT, HIT, file 
records, and/or BOOT sector will be updated to 
the disk. Although the entire directory is repaired 
in memory, only the requested data to be fixed is 
written back out to the disk. The utility 
PFIX/CMD is capable of fixing most errors that 
may be reported by PCHECK. 

If only the GAT and/or HIT are specified, and 
an error is found in any of the files directory 
records, the fix will abort and a message will be 
returned requesting you to use the "F" option. This 
is because it would be unreliable to repair a GAT 
or HIT when the root information is invalid. This 
is to prevent a user from inadvertently destroying 
any relevant data. 

The following is a list of the errors that PFIX 
can fix. A technical section will follow that will 
describe the logic used by PFIX, and probable 
causes for the error conditions. 



13. Directory record has invalid HIT byte 

14. Directory record has a zero HIT byte 

15. Extended directory record has invalid HIT 
byte 

16. Extended directory record has a zero HIT 
byte 



1. Cylinder xxx has an invalid GAT table byte 

2. HIT byte at xxH invalid or extraneous 

3. Filename contains non-ASCII characters 

4. End of File Sector beyond allocated sectors 

5. No terminator for extent field 

6. Directory links to record not linking back 
to it 

7. Track assigned that is beyond diskette 
boundary 

8. Extension assigned before end of extents 

9. Forward link to inactive entry 

10. Forward link to non-extension entry 

11. Extension record not assigned to any files 

12. Multiple files assigned to single granule 
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Directory Repair Logic 

This section contains the logic that PFIX us< s 
to repair the directory. The novice user need mt 
be concerned with this information as it is offered 
only as technical reference for the advanced user 

Pass ttl 

Check to be sure that all 11 bytes of tl e 
filename contain characters within the range f 
20H to BFH (printable ASCII characters). If aiy 
are found to be outside this range, replace with i n 
"X". (If this occurs, a HIT repair will be requind 
to access this file from LDOS™) 

The 5 extents of the associated file record ai e 
each checked on a sector by sector basis. If ary 
extent points to a track that is beyond tl e 
diskette boundary, a terminator (FFH) is entered t 
the current location. 

If any granules are indicated in a file's extent t, 
and the corresponding GAT bit is set (assigned o 
a previous file), the record will be terminated t 
the current location. 

If all 5 extents have been parsed, and r.o 
terminator was found (FEH or FFH) then a 
terminator is entered at the last position. 

If an extended record is found, and it is not rt 
the 5th position in the extent field, the error s 
ignored and the program continues. 

If the extended record is found, its position n 
the directory is located. If bit 4 of the first by e 
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in the record is not set (inactive file), the 
extension is unlinked. If bit 7 is not set (not an 
extension), it is also unlinked. The second byte in 
the extended record is a link back to the previous 
record. If this byte is incorrect, the extension is 
unlinked. 

The un-linking of the files is to protect against 
possible overlaying another file that does not in 
fact link back to the primary. By unlinking a file, 
data past the link will be lost, but the data will 
not accidentally be force-linked to an incorrect 
entry. 

This process continues until an FFH terminator 
is reached, or a terminal error is found and a 
terminator is forced. 

When processing is completed, the number of 
sectors assigned to the file is calculated and 
compared to the end of file sector in the directory 
record. If the end of file is larger than the 
allocated records, then force the number of 
allocated records into the end of file sector. 

Pass tt2 

This pass constructs the HIT table. Each file is 
traced from its primary directory entry through all 
extents until an FFH terminator is reached. The 
entire HIT table will be reconstructed starting with 
a page (256 bytes) of zeroes. All active primary 
and extended directory records are logged correctly 
into this table. 

Pass 83 

This pass constructs the GAT table. As with 
pass 2, each file is traced through all of its 
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lJJo C J^ d pnS C °5 d ? J i then f ° rCe the nUmber ° f al l°"ted records 
into the end of file sector. 

Pass \2 

iK Th i'. pass constructs the HIT table. Each file is traced from 
llLi^ll ^ dlrec t^y entry through all extents until an 
term nator is reached. The entire HIT table will be reconstructed 
starting with a page (256 bytes) of zeroes. All active primary 
?able? directory records are logged correctly into this 

Pass #3 

This pass constructs the GAT table. As with pass 2 each flip 
is traced through all of its extents. The entire gat' table w I 
be re-constructed starting with all null characters. All active 
thls a tab?e eXtended directory records are logged correctly into 



type of error Tn ^ f M *"?. WiU inhere "tly cause another 
several n Li *? theSe ""?' flXlng even one error ^y correct 
1 others. as an example, if there is no terminator for a 
record, repairing this will sometimes correct a multiple files 
assigned to a single granule error. P I1Ies 



When using this uti 
that may be repaired th 
sets aside an extra tra 
track as allocated in 
Laredo and Radio Shack 
not be used. The PFIX 
it is not assigned to 
systems, and cannot be 
this situation, PFIX w 
conditions are met: 



lity on Rigid drives, there is one error 
at the user should be made aware of. LDOS 
ck (the location can vary), and shows this 
the GAT table. This track is used by the 
hard disk systems as overhead, and should 
utility will de-allocate this granule, as 
any files. This is only on rigid drive 
detected via the DCT parameters. Due to 
ill allocate this track if the following 



1. The drive being fixed must be a Rigid drive. 

2. The GAT fix option must have been specified 

3. The GAT entry for the required cylinder (middle 
track for the Laredo, Track 1 for the Radio Shack 
rigid disk) must be a null byte (not allocated to 
any files) after the GAT re-build. 

4. The L or R option must have been specified. 



If these conditions are met, then the extra trark ic 
automatically allocated. This could essentially lockout 1° 
available track on a non-Laredo or non-Radio Shack rigid disk 
system, but will cause no other problems. if you are not sure if 
your rigid system uses this cylinder or not, then please consult 
the manufacturer or Logical Systems Inc. It is better to lock out 
a cylinder than crash the system. iOCK out 



Copyright (c) 1982 by Breeze/QSD, Inc. 



User's Manual 



21 



cmf in L PFIX 1 ° n a Model I double-density system disk with the 

Ssi^fe"?} ^?^- C3 ^ Se TraCk fl t0 be ^-allocated" I h 
undesirable. If this is the case, then the PMOD utility must be 
used to re-allocate Track in the GAT table to prevent the 
den^Tv l° m , at n tem P tin 9 to "e non-existent sectors n in 

GA? table"^ h"^ ^ S ° LE ' Usin 9 the command ™™ :d,| ?he 
GAT table can be displayed. Change the first byte of the 
displayed sector to FFH and write the sector back to the d?sk 
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The TOOLBOX for LDOS 



The PREFORM utilit-u i c = ,,- , 
the user to easflj *epai? ?"* "-^matter program. 
Only 5 - Floppy Disk y s ^L f""° r " ot f ?"nd« and -ci 



It allows 



REFORM command i: 



systems. 



PREFORM, :a,b,c 



•a - drive to be re-formatted ( - 7 , 
J = Y or N (pause on faulty sectors 
c - starting cylinder (default ° 



abbr: NONE 



proceed as follows: ' he " the "-format operation will 

The current trark u ni u 

The track wi^be" ? orma Ld!^ int0 —• '* s ^<" by sector. 

The track will be re-written back sector by sector. 

optKn :- n . y :^, r f 8 i.r;o r u d ;i r ir 9 x^s- 3 «-p«. andt he Y 

;;[L to R > e try, s>ki P , or b A> b "r a J " r ° r ^ssage, and 
specified, processing will continn* ^f;: If the N option was 
the entire disk has 9 been re-^™^^ ?£ error "essajes. When 
^ read into memory, and "' ^he directory ?rack I 
read-protect data address marks baCk with the P^per 

and^hrro^fne'wnr^rmTna^e^r' )T ^ P reSS the BREAK key 

P-s P sL t a ed \H ThiS WU1 a "- "or^JXauIn""? ^ haS ^ 
Pressing the RESET button ^ termination of the program 

recommended, as the current track t^'K th * pr °9 ram is not 
Program is aborted, a e , V ? e tota lly lost. if ?£t 

- "S^'-JipSJMjJ b -- ! P-"cte r d? k m^tn^fL ">"" 
diskette. "^^ (allen )" command to gain access back to £he 

If any CRC errors exi<:h^ 
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on the diskette, thev al<5n win u 
contents of the sector !!?? u U be 
the diskette to be reused i>H C ° mpl 
was on the director^ tr^ck ^t" 
th e e COr u d s S er ay ^ been '-"also. \t 

recopy thP nr re - formatti ng process, i 

»-°K.s:y p ;!K-::.sr th ":';.:;'!V 



corrected, but the 
etely lost. This wi 
losses, if the faul 
is possible that s 
is strongly recomme 
f valued data in 
errors. if sectors 
t is advised that 
ed to the faulty sec 
resolving this. 
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previous 
11 allow 
ty sector 
ome files 
nded that 
order to 
are lost 
the user 
tors. The 



This program will also «F r «cu „ 
diskettes have a "shelf" I?? P ll 6S ^ en a diskette. Formats 
manufacturers. B y re-'for'mf ting' ^dlske^ " ^^^ToTolt 
strengthened, and the shelf i f» .?, d * skette » the data will h P 



loss of data will 
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PVU 



PCLEAR 



The PVU program iw a comprehensive disk verification utility. 
It allows the user to easily locate and identify faulty sectors 
on a disk. All LDOS supported disk devices may be operated on, 
including Single/Double Density, Single/Double Sided, 5" and 8" 
floppies and fixed/removable disk systems. The syntax of the PVU 
command is: 



The PCLEAR program is a comprehensive disk clean-up utility. 
It allows the user to easily erase unassigned granules and 
directory records. All LDOS supported disk devices may be 
operated on, including Single/Double Density, Single/Double 
Sided, 5" and 8" floppies and fixed/removable disk systems. The 
syntax of the PCLEAR command is: 



PVU,:a,b,c 

:a = drive to be verified (0-7) 
b = Y or N (pause on faulty sectors) 
c = starting cylinder (default 0) 

abbr: NONE 



When the desired parameters have been selected, the specified 
drive will be read to determine the diskette type (cylinders, 
density, sides). Each cylinder will then be read sector by 
sector. If any errors are found, and the Y (pause) option was 
given, you will be given the option to R>etry, S>kip, or A>bort. 

When the disk verification process has been completed, you 
will be given the number of sectors checked, and the number of 
sectors that were not read successfully. if there were bad 
sectors, you will be prompted to press ENTER for the list of 
faulty sectors. Each bad sector will then be liste.d to the video. 



PCLEAR, :a,D,S,b 
PCLEAR, filespec,b 



:a = clear this drive (colon optional) 
D = clear unused directory records 
S = clear unassigned sectors 
filespec = any valid LDOS filespec 
b = fill command (default 00H) 
fill = |cc (numeric value) 
= "cc" (ASCII string) 

(numbers and ASCII can be mixed) 

abbr: NONE 



After selecting the desired parameters, one of 
routines will be executed. 

If a disk was specified to be cleared: 



the following 



If the S option was given, the directory GAT table will be 
read into memory. All non-allocated sectors will be written to 
with the defined fill data. If the D option was given, then all 
directory records that do not have bit 4 set (i.e., inactive 
records) will be set to all zeroes. 

If a file was specified to be cleared: 

All sectors assigned to the file will be written to with all 
the defined fill data. This will destroy all data belonging to 
the file. 

The user may optionally define what data is to be written into 
the empty sectors. The default value is zero (00H). A single 
pound sign (#) followed by a one byte numerical value (0-255) to 
be used as the fill byte. The number may be entered in Binary, 
Decimal, Hex, or Octal by preceding the number with B, D, H or 
respectively (default decimal). A quotation mark (") followed by 
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a string will copy this string repetively into the empty sectors. 
Numerical values and strings may be intermixed. 

Examples : 



PSS 



PCLEAR,:0,d,s,fh40 
Fill all unassigned granules with sectors filled with the byte 
40H, and clear all unused directory records. 



PCLEAR, dead f ile/cmd: 3, "message" 
Fill all sectors currently assigned to file 
with the repetitive string "message". 



"deadf ile/cmd' 



PCLEAR, :7,s, 195, "Kim was here" 

Fill all unassigned granules with the string "Kim was here" 

preceded by the cursor character (ASCII 95 decimal). The fe.j 

terminating quote may be left out if it is the last character on W 
the line. 

When a file is killed with LDOS, several actions occur. First 
the first byte of all primary and extended directory records is 
set to 00H. All granules assigned to the file are released and 
made available in the GAT table. All primary and extended 
directory records have their corresponding HIT bytes set to 0. 

This will KILL a file, and make it inaccessible to LDOS, but 
all the information is still there. The directory record is still 
in the directory, but it is indicated as inactive by the system. 
All data that was assigned to the file is also still on the disk. 
Only the directory record has been changed, none of the data has 
been touched. At this point, a couple of minor changes to the 
directory can reinsatate the file and make it totally available 
again with full access to the data. 



The PSS program is a Sector Status Utility. It allows the user 
to easily identify which file is assigned to any sector on a 
disk. All LDOS supported disk devices may be operated on, 
including Single/Double Density, Single/Double Sided, 5" and 8" 
floppies and fixed/removable disk systems. The syntax of the PSS 
command is: 



PSS, :a,b,c 

:a = drive number (0-7, colon optional) 
b = cylinder number 
c = sector number 

abbr: NONE 



When the specified parameters have been entered, PSS will read 
the designed directory. If not enough memory is available, PSS 
will abort with an error message. Otherwise, the drive type will 
be displayed along with the name, date, and number of free 
granules on the mounted diskette. If the sector is not assigned 
to any files, an appropriate message will be displayed, and an 
exit made back to LDOS. If it is assigned, the filename, and the 
relative sector number in the file will be returned. 



By running PCLEAR on a drive, you may safely remove all traces 
of both the files data, and it's associated directory record. If 
you have a disk that has been used several times, chances are 
that several "killed" files are still on the disk. If this disk 
was given to a programmer, chances are that the data could be 
"unkilled". PCLEAR will make sure that even the best programmer 
cannot access any of the killed files on your disk, because the 
information has been completey removed from the disk. 

The FILE option of PCLEAR is a very powerful feature, but 
could be disastrous if you are not careful. This will totally 
erase all data assigned to the file. Each sector will contain the 
specifed fill data. This routine could be useful to set all bytes 
of a file to a known initial value to be used as a data file. 
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PMAP 



byscems. The syntax of the PMAP command is: 



PMAP,*,: a 
PMAP,*,filespec 



* = send output to printer 

:a = map this drive 

filespec = any valid filespec 

abbr: NONE 



Mapping a File: 

The associated 
read into memory, 
through the direct 
operated on will 
specified) . An at 
computed. If the 
surrounded by a th 
by the system, the 
by graphic blocks, 
or pause by pressi 
the end of file is 



directory record for the given file will be 
All sectors assigned to the file will be traced 
ory manually. The current sector that is being 
be displayed to the video (or printer if 
tempt will be made to read each sector as it is 
_ sector was read successfully, it will be 
in line (ASCII 95). If a read error was issued 

cylinder and sector number will be surrounded 

At any time, you may abort by pressing BREAK, 

ng SHIFT @. This procedure will continue until 

reached, and an exit is made back to LDOS. 



Mapping a drive 
The 




Cylinder 00: 00-04xx 05-09xx 

indicate the range of sectors in the first qran This L i 
second x position indicates the stat-nc; „ f ..iL * \J 
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PASSGO 



PUN 



utility PA ?f G0 ,ir Ogra TK IS 3 COI "Prehensi V e password removal 
y ; n " allows the ^er to easily remove passwords on a 

systems. The syntax of the PASSGO command is: 



PASSGO, :a,V, I, S,N 
PASSGO, f ilespec 

:a = remove all passwords this drive 
V = include VISIBLE files (default) 
I = include INVISIBLE files 
S = include SYSTEM files 
N = exclude visible files 
filespec = any valid LDOS filespec 



abbr: NONE 



Once the specif ed parameters have been entered, one of the 
following 2 routines will be performed: 

should note that if the file CONFIG/SYS is affected bv thfJ 
cor^ed 1 ^ 111 "° l0nger ^ l0adSd by the s^t- Thi^y^ 

ATTRIB CONFIG/SYS (acc=ccc,upd=ccc,inv) 

its^ccV^nH HoiL,, haS b6en s P ecifie ^ then that file will have 

^efwuf be d se U DA to F (;Si rdS .c£,, t0 J} 1 : and the P"t.ctlon 

pyi , K Fnr fho -.,' ■ * t £Ulx access), if a password currently 

iTs 5 s^ o [o th b t f u P ij ^^sr^r s: c r;r d i for the 

commands would be identical: following two 

PASSGO f ilename/ext.password'd 

ATTRIB filename/ext. passwords (acc=,upd=,prot=f ull) 



A 



The PUN utility is a Diskette Un-Repair program. It allows the 
user to easily reverse the effects of a "repair (alien)" command 
that was used to convert the data address marks used by TRSDOS to 
that used by LDOS. This will allow TRSDOS I to access a directory 
written to by LDOS. This program will only work in a Model I (the 
Mod III cannot reproduce the desired address mark), and will only 
operate on a single density, single sided, 5" floppy disk. The 
syntax of the PUN command is: 



PUN,: a 

:a = drive number to un-repair 



When the appropriate parameter has been specified, the 
directory will be read into memory, and immediately written back 
with the Mod I read-protect data address marks. This will allow 
TRSDOS I to access the directory again. 

In order to gain compatibility between the models I and III, 
LDOS has chosen to write the single density directories on a Mod 
I using the User Defined Address Mark. This will cause TRSDOS to 
report a read error on the directory, or at least cause a lot of 
thrashing while the system does a re-seek 10 times for each 
sector. One pass through PUN, and no more problems. The diskette 
will become readable to a TRSDOS I system, and will also remain 
readable to LDOS. 
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PKILL 



a n PKIL !\. is a com P re '>ensive multiple-file purge utility which 
allows the user to quickly and simultaneously kill several files 
or r0m t h a e dl s S ta nd F a r r V killed "^ bs classified usfng^rtspecs 
Alternative?C fl ii^^'r? ° f Visible ' Invisible or System. 
Alternatively a list of files to be killed may be supplied on 
the command line when the utility is invoked. PKILL may be used 
on all LDOS supported disk devices including 5" or ' 
single/double sided, single/double density floppy disks and rigid 
drives. The syntax of the PKILL command is: 9 



PKILL :a,!,V,I,S,N,A,L,R,/ext,$wild 
PKILL :a,*,/ext,filel,file2,file3 .. 



:a = 
! = 

V = 
I = 
s = 
N = 
A = 
L = 
R = 
/ext 
$wild 

* = k 

a 
n 



drive number, through 7 (colon optional) 
erase directory entry of affected files 
Include VISIBLE files (default) 
Include INVISIBLE files 
Include SYSTEM files 
Exclude visible files 
Include ALL files 
Indicates a LAREDO rigid disk 
Indicates a RADIO SHACK rigid disk 
= include files with this extension 
= Include files starting with the charac- 
ters "wild" 
ill all files in the list following this 
sterisk (supply default extension if 
eeded) . 



Abbr: NONE 



PK 
sever 
class 
I {nvi 
exten 
chara 
be ki 
f i len 
neede 
up to 
hard 
Shack 
that 



ILL allows the user to quickly and simultaneously kill 
al files from a disk. The files to be killed may be 
ified according to the standard categories V(isible) 

"on^ o r fi S lil Ste V-\ °l .^ be f11 " ^h T common 
nlT r ' a p-, U f? u whlch begin with a particular set of 
ill* \ Flles „ wh * cn have NO common characteristics may also 
lied by entering an asterisk (*) followed by a list of 

d^All r^ 1 ^f r^- be assi 9 ned * default extension if 
All LDOS-supported disk devices are supported by PKILL 
and including hard drive systems. When using PKILL on a 
drive system, the L (for Laredo systems) or R (for Radio 

it y ?s e de S ali Param ^ er mUSt alS ° bS S ^ Ued t° info™ PKILL 
it is dealing with a rigid disk system that requires a track 



%; 



•9 



locked out for system use. A colon is optional when specifying a 
particular drive number. 

After the user selects the desired parameters, PKILL reads the 
directory track of the target disk into memory and proceeds to 
kill the necessary files. It then writes the now-modified 
directory back onto the disk. This procedure allows a very fast 
kill of multiple files. 

If the "1" parameter is not specified, the files are merely 
flagged as inactive in the directory, leaving the possibility of 
later recovering a killed file. However,. if "!" is specified, the 
entire directory entry for a killed file is zeroed out, making 
later recovery impossible. 

Any combination of the parameters V, I, and S are permitted by 
PKILL. N and V are mutually exclusive. The use of the "A" 
parameter is a very good way to produce a data disk with a 
totally blank directory and the user should exercise caution when 
using it. 

When a list of files is supplied, an asterisk should be 
entered as the first item to inform PKILL that what follows is a 
list of files and not additional parameters. PKILL will kill each 
file in the list. 

Default extensions for files to be killed may be supplied by 
entering the extension after any file classification identifiers 
(S, I, V, etc) or in front of a list of files. In the latter 
case, the extension will be added to any filenames on the list 
which do not have explicitly typed extensions. To avoid having 
the default extension added onto a file, it must be entered as 
FILE/ to force a blank extension. 

If PKILL is typed in without any parameters, the user will be 
prompted to supply them when the program starts. At this point 
the user may type in the necessary information. Up to 255 
characters will be accepted. It may be useful, therefore, when 
entering a long list of filenames to simply enter PKILL and then 
type the list of names at the prompt. This is because the LDOS 
command buffer limits keyboard entry to only 64 characters. 

EXAMPLES: 

PKILL :0,I,/CIM 
This command will cause all visible and invisible files on 
drive with the extension /CIM to be killed. Note that since V 
defaults to ON, it is not necessary to type it in. 

PKILL :3,!,/DAT 
All visible files on drive 3 with the extension /DAT will be 
killed. The slots they occupied in the drive 3 directory will be 
zeroed out. 
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PKILL :1,!,A 
This command will produce a totally blank data diskette on 
drive 1. All files except for BOOT/SYS and DIR/SYS will be killed 
and their directory entries zeroed out. 

PKILL :0,*,/cmd,test,test2,prog/bas,Foo/ 
The files TEST/CMD, TEST2/CMD, PROG/BAS and F00 will be 
killed. All the files must exist on drive 0. 



PCOMPARE 



The PCOMPARE program is a comprehensive disk/file compare 
utility. It allows the user to locate inconsistencies between 
disks or files. All LDOS supported disk devices may be operated 
on, including Single/Double Density, Single/Double Sided, 5" and 
8" floppies and fixed/removable rigid disk systems. The syntax of 
the PCOMPARE command is: 



V 



4 



PCOMPARE, *,: a, b,c,d,:e,f,g 
PCOMPARE, *,f ilel,f ile2,h 

* = output to printer 

:a = source drive (0-7) 
b = source track (default 0) 
c = source sector (default 0) 
d = sector count (default to disk end) 

:e = destination drive (0-7) 
f = destination track (default 0) 
g = destination sector (default 0) 
filel, file2 = any valid LDOS filespec 
h = starting relative sector (default 0) 

abbr: NONE 
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After selecting the desired parameters, the source data will 
be loaded from disk one sector at a time, and compared to the 
specified destination sector. If any bytes do not match, their 
locations will be reported in the following format: 

:x, Cyl xxx, Side x. Sect xxx <<==>> :x, Cyl xxx, Side x, Sec xxx 
At Relative xxx (xxH) to yyy (yyH) for xxx (xxH) byte(s). 

Data Mismatch File Relative Sector xxxxx. 

At Relative xxx (xxH) to yyy (yyH) for xxx (xxH) byte(s). 

This will continue until all bytes in the sectors have been 
compared. When all sectors have been compared, the following will 
be displayed: 

xxxxx Total Sectors Compared. 
xxxxx Sectors Did Not Match. 
xxxxx+Bytes Did Not Match. 

The plus sign at the byte mismatch message will appear if more 
than 65535 (FFFFH) bytes total did not match, otherwise it will 
be absent. 
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PFIND 

The PFIND program is a comprehensive string search and replace 
utility. it allows the user to locate and replace strings in 
memory, in a file, or the disk on a sector by sector basis. All 
LDOS supported disk devices may be operated on, including 
Single/Double Density, Single/Double Sided, 5" and 8" floppies 
and fixed/removable rigid disk systems. This program will locate 
strings in several different formats, and upper/lower case 
independent searches may be specified. The syntax of the PFIND 
command is: 



PFIND, *,g,:a,b,c,d,s,>t 
PFIND, *,@,filespec,e,s,>t 
PFIND, *,@,ffff,gggg,s,>t 



= output to printer 
@ = display match locations 
:a = drive number (0-7, colon optional) 
b = starting cylinder (default 0) 
c = starting sector (default 0) 
d = sector count (defaults to disk end) 
filespec = any valid LDOS filespec 
e = starting relative sector (default 0) 
ffff = memory start address 
gggg = ending address (default topmem) 
s = string to locate 
>t = replacement string (optional) 
string = "abcde????fgh" 

(literal string, case dependent) 

= 'abcde????fgh' 

(literal string, case independent) 

= abcde????fgh 

(? matches anything, case independent) 

= f,a,b,c (byte list) 

= f#,a,b,c (word list) 

abbr: NONE 



After selecting the desired parameters, the search will beqin 
at the specified starting location. if a disk or file search is 
requested, the entire string must be contained wholly within a 
sector, as no spanning across sectors is done. if any matches are 
found, and the @ option is specified, their locations will be 
TP t ^ ne f t0 the video ' or the Printer if the * option is given. 
If the @ was not issued, the location will be counted, but not 
displayed. If a replacement string was given, it will be written 



%J 



back to the source data. If any errors occur during either the 
read or write cycle, you will be issued an error message, and 
given the option to R>etry, S>kip, or A>bort. If a replacement 
string was specified that is longer than the source string, it 
will be truncated to the length of the source string. 

The following types of strings will be accepted by the system: 

Literal string, case dependent: "string" 
By surrounding the string with quotation marks ("), it will be 
interpreted by PFIND as a literal string, no conversion of .case 
will be made. Each letter specified must match exactly . This 
means that upper case and lower case are treated as separate 
characters. If the source string is "Kim" for example, then KIM 
will not match because the i and m are considered different 
characters. 

Literal string, case independent: 'string' 
By surrounding the string with apostrophes ('), it will be 
interpreted by PFIND as a literal string, but all characters will 
be converted to upper case. When scanning for matches, each 
character of data is converted to upper case before the 
comparison is made. This will allow you to locate matches even if 
the upper/lower case characters do not match exactly. If the 
source string is 'Kim' for example, then KIM, kIM, kirn, etc. will 
all match. The upper and lower case characters are considered 
equal in this type of search. 

? matches anything, case independent: str?ng 
This type of search is identical to the above mentioned 
example, except that any question mark characters (?) will match 
with any characters in the data searched. If there are no ? 
characters in the string, then this and the above would be 
identical in all respects. If the source string is K?m for 
example, then KIM, kIM, kirn, kam, kxm, etc. will all match. The 
upper and lower case characters are considered equal. 

Byte list: |,a,b,c 
This type of search will allow you to specify any string of 
bytes. The single pound sign (I) tells PFIND that a list of one 
byte numerical values will be following. The values may be made 
in Binary, Decimal, Hex, or Octal by preced ing the number with B, 
D, H or respectively (default decimal). All numbers indicated 
must be in the range of 0-255 (0-FFH) . 

Word list: ||,a,b,c 

This search allows a string of 2 byte words. The double pound 

sign (||) tells PFIND that a list of 2 byte numerical values will 

follow. The values may be in any number base following the rules 

in byte list. All numbers must be in the range of 0-r>5535 
(0-FFFFH). The numbers are placed into the string in LSB, MSB 
order . 
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Sample Strings: 

^Kim Watt" becomes 4BH,69H,6DH, 20H, 57H,61H,74H,74H 
Kim Watt' becomes 4BH, 49H,4DH, 20H,57H,41H, 54H,54H 
Kim Watt becomes 4BH,49H, 4DH,20H,57H,41H, 54H,54H 
1,1,2,3 becomes 01H,02H,03H 
IS, 1,2, 3 becomes 01H,00H,02H,00H, 03H,00H 

If you are searching memory, the locations will be reported as 
follows: 

Memory Match at xxxxH 
foll E ^° U 3re searching disk sectors, locations are reported as 
Disk Match, Drive x, Cylinder xxx, Sector xxx, Relative Byte xxH. 

If you are searching a file, then matches are reported as: 
File Match at Relative Sector xxxxx, Relative Byte xxH. 



The following are sample command lines: 

PFIND,*e:0, 'kirn watt»,>"Kim Watt" 
Searches drive from start to end. If the string 'Kim Watt' 
appears in ANY case, replace with the string "Kim Watt" in 
upper/lower case. If any matches are found, they will be 
displayed to the video and printer. 

PFIND,:0,'kim watt' 
Searches drive from start to end. Reports the total number 
of occurences of the string 'Kim Watt'. Locations are not 
displayed, only the total number of matches. 

PFIND,@pfind/cmd,kim watt 
Searches the file PFIND/CMD for all occurrences of the string 
Kim Watt" in either upper or lower case, and list heir 
locations on the video. 

PFIND,esys0/sys,f#,h4411 

un HlmS S ,K the £il l SYS0/SYS for a11 occurrences of the binary 
word 4411H (topmem Mod III), and reports their locations on the 
video . 
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PMOVE 



The PMOVE utility is a comprehensive file copy program. It 
allows the user to easily transfer multiple files from one disk 
to another with a minimum amount of keystrokes. All LDOS 
supported disk devices may be operated on, including 
Single/Double Density, Single/Double Sided, 5" and 8" floppies 
and fixed/removable disk systems. The syntax of the PMOVE command 
is: 



PMOVE, :a, :b,/cde,f ilel,f ilel>f ile2 

:a = source drive number (0-7) 

:b = destination drive (0-7) 

/cde = default extension for all files 

filel,2 = any valid LDOS filespec 

> = rename file to following filename 

followed by a list of files 

abbr: PMOVE, ab/cdef ilel, f ile2 



Once the desired 
destination directo 
The command line ma 
DOS command level, 
from LDOS, you will 
If prompted from th 
buffer to specify 
asterisk character 
not be cleared wh 
directory on the sc 
the 255 character 
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parameters have been entered, the source and 
ries will be read to establish the disk types, 
y be specified sith the program name from the 

or you will be prompted for it. If entered 
be limited to the 63 character input buffer. 
e program, you will have a full 255 character 
the files. You may also optionally enter the 

(*) as the first command, and the screen will 
en the program initializes. If you have a 
reen, type PMOVE,* and you will have access to 
input, and the filenames will still be on the 



PFIND,@h4000,|#,h4411 

„„,, - :rom 4000H to TOPMEM _ „ ilIH1 y 

4411H, and reports the locations of all matches on the video. 



Searches memory _ from 4000H to TOPMEM for the binary word 



PMOVE may be used to copy a single file: 

PMOVE, 01pmove/cmd 

but the time saving is really noticed when several files are to 
be copied: 

PMOVE r 01/cmdpmove,pmod,pvu,pf ilt/f lt,passno,pmap 

the above command will copy 6 files from drive to 1, and the 
default extension of /CMD will be added to all files except 
PFILT/FLT. 
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PMOVE may also be used to duplicate the same source file to 
several destination files using the rename capabilities: 

PMOVE 01/cmd,pmove,pmove>pmovel,pmove>pmove2, pmove>pmove3 

the above command will take PMOVE/CMD from drive 0, and create 4 
identical files on drive 1 named PMOVE/CMD, PM0VE1/CMD 
PM0VE2/CMD, and PM0VE3/CMD. 
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PERASE 

The PERASE utility is a Software Bulk-Erase program. It allows 
the user to easily remove all traces of data on a diskette, and 
return it back to a blank state. Only 5" Floppy Disks may be 
operated on, including Single/Double Density, Single/Double Sided 
disk systems. The syntax of the PERASE command is: 



PERASE, :a 

:a = drive to be erased (0-7) 

abbr: NONE 
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Each track will be formatted with all bits off (zeroes). This 
will effectively remove all traces of sectors and data on the 
diskette. If you wish to abort the program, press the BREAK key, 
and the routine will abort at the completion of the current 
track. When the entire disk has been erased, it may be considered 
a completely blank disk. The program will essentially perform the 
same task as using bulk-erase magnets to delete all information 
from the disk. 
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PDIRT 



PEX 




I PDIRT,:a,I,S,0,P 




I :a = drive number (0-7, colon optional) 




I I = include INVISIBLE files 




! S = include SYSTEM files 




! = include system OVERLAYS 




I P = output to printer 




! abbr: NONE 
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The PEX utility is a diskette exerciser program. It allows the 
user to move the head to any cylinder (for alignment purposes), 
or to move the head in a continuous motion (for cleaning disk 
purposes). The syntax of the PEX command is: 



PEX,:a,bbb 

:a = drive number (0-7, colon optional) 
bbb = cylinder count 

(optional if formatted disk mounted) 

abbr: NONE 



Once the specified command has been entered, the specified 
drive head will be restored (moved to cylinder 0), and a sub-menu 
will be displayed. Several keys are recognized by the program at 
this point: 

D allows you to specify a new drive number 

C allows you to move the head to any cylinder 

S set a new step rate for the drive 

A automatically step from cylinder to the 

top cylinder 

R move the head to cylinder fl 

T move the head to the top cylinder 

If the automatic mode has been set, any of the other commands 
will terminate the operation. Pressing BREAK at any time will 
abort the program and return control to LDOS. 
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PMX 



%> 



^^ 



This filter will adjust graphic characters so that they are 
printed out as normal TRS80 graphic when using an Epson MX80 
printer. The syntax of the command is: 

FILTER *PR,PMX 

The MX80 printer will not print standard TRS80 graphics unless 
it is set in the TRS80 mode, in which case you lose some of the 
special printer capabilities of the machine. This filter will 
allow use of these special features while correctly printing 
graphic characters identical to the TRS80 computer. 
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PHELP 



with the" Sn^i.h" 111 all ° W 6aSy 3CCeSS t0 the s y nta * associated 
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PHELP * 
PHELP *,? 
PHELP *, command 

* sends output to printer 
? displays syntax for PHELP 
command - displays syntax for 
the associated command 

abbr: commands may be abbreviated 



# 



PFILT 



This is a comprehensive, user definable conversion filter that 
may be used for either input or output devices. The program will 
read an ASCII text file created by the user (via the BUILD 
command) to determine the parameters. The syntax of the PFILT 
utility is: 



FILTER *aa PFILT, filespec 

aa = any LDOS defined device 
filespec = any valid LDOS filespec 
default extension /JCL 

abbr: NONE 



When the desired 



n " " e desired command has been issued, the associated 



This command will read the designated file and create a table 
of the parameters in the file. The entire program will then 
relocate itself to high memory, and protect itself. The format of 
the data file is as follows: 

A numerical value, followed by an equal sign (=) , followed by 
the value to be converted to. 

If the first character is a colon (:), then the following 
character is interpreted in its ASCII form. 

If the first character is a period (.), then the following 
data on the line is considered a remark, and is not executed, 
although it will be displayed to the video. 

All numerical values may be entered in Binary, Decimal, Hex or 
Octal by preceding the number with B, D, H or respectively 
(default decimal). J 

Following are examples of acceptable syntax: 

31 = 37 

31=h44 
o37=d44 
bll011011=ol77 
hff=hfe 

:A=a 

:Q=B 
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Two sample filter files for use with PFILT are included on 
the disks, called CODE/JCL and DECODE/JCL. These sample files 
show how PFILT may be used for coding/decoding purposes. These 
are not supplied as sophisticated techniques, but merely as 
examples demonstrating the power of the PFILT filter. The syntax 
of the commands are: 

FILTER *KI, PFILT, CODE 
FILTER *DO, PFILT, DECODE 

(The PFILT program uses the default extension /JCL which is the 
default extension supplied to files by the BUILD library command 
of LDOS) 

Normally, you would only want to have one driver in memory at 
a time. When the *KI is being filtered, only upper case inputJ 
will be changed, thereby allowing the user to enter DOS commands^ 
in lower case. Use the SPACEBAR to enter commas while the CODE 
filter is active. Following is a sample session demonstrating the 
capabilities of the system: 

(Enter the case exactly as entered below) 

filter *ki ,pf ilt,code 

build test/fil:0 

THIS IS A TEST OF A CODED MESSAGE. <ENTER> 

<BREAK> 

reset *k i 

LIST TEST/FIL:0 

(SHOULD NOT BE READABLE!) 

filter *do ,pfi It, decode 

list test/fil (SHOULD NOW BE READABLE!) 

reset, *do 
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DVORAK/FLT 



This is the filter file for the famous DVORAK keyboard. It 
contains drivers for both DVORAK and QWERTY, and each driver may 
easily be toggled to the other. The program also allows a caps 
lock function. The program may be terminated at any time, and the 
memory it is using will be reclaimed if it was the last driver 
into high memory. The syntax of the DVORAK command is: 



FILTER *KI, DVORAK, a 

a = Q or D if the program will 

initialize as QWERTY or DVORAK 
(default DVORAK) (optional) 

abbr: NONE 



This will load the driver into memory, at which time it will 

relocate itself to high memory and protect itself. It is 

recommended that the user SET *KI KI/DVR before setting up the 
DVORAK filter so that the control keys will be active. 

You may toggle between DVORAK and QWERTY by pressing the CLEAR 
0. The SHIFT toggles the upper case lock feature. The driver 
may be disabled with CLEAR BREAK. If it was the last file into 
high memory, then the memory that it occupies will be reclaimed 
to the system and a corresponding message will be displayed. 

There is another DVORAK file on your disk, called DVORAK/JCL. 
This is the DVORAK keyboard filter file that can be used in 
conjunction with the PFILT filter. It is a pure ASCII data file, 
and although it does not provide the user with the full features 
of the DVORAK/FLT utility, it does require much less memory. The 
syntax of the command is: 



FILTER, *KI, PFILT, DVORAK 



abbr: NONE 



After this command, the DVORAK filter will be installed, moved 
to high memory, and protected. 
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PBOOT 
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system 
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NOTICE 



This software is sold on an AS-IS basis' only, and Breeze/QSD 
shall not be liable for any damage or loss, whether real or 
alleged, arising from the use of this software. No warranties of 
merchantability or fitness are made, expressed, implied or 
imagined. Installation and determination of fitness for a 
particular purpose is the sole responsibility of the user. 
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